home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / pcplus2.zip / ADDENDUM next >
Text File  |  1988-01-01  |  3KB  |  93 lines
  1. PROCOMM PLUS - Addendum to the User's Manual
  2.  
  3. Copyright (C) 1987 DATASTORM TECHNOLOGIES, INC.
  4. All Rights Reserved
  5.  
  6. The following additions and corrections apply to
  7. PROCOMM PLUS version 1.0.
  8.  
  9. Additions:
  10. ------------------------------------------------------------------------
  11. - An editor has been included with PROCOMM PLUS.  The editor program,
  12. called PCEDIT.EXE, is a small, fast text editor suitable for use writing
  13. ASPECT scripts and the like.  It is provided as a seperate executable
  14. file called via the [Alt-A] editor command.  It may be run standalone
  15. as well with a command of the form "PCEDIT filename [/b]". The optional
  16. "/b" parameter causes the editor to operate in black and white rather
  17. than color for composite monitors.  Help for PCEDIT may be obtained
  18. by pressing [Alt-Z] from within the program.
  19.  
  20. - The Redisplay buffer has an additional command: W (Write file).  When
  21. selected, the contents of the Redisplay Buffer will be written to a disk
  22. file of the specified name.
  23.  
  24. The ASPECT script language has the following additional commands:
  25.  
  26. -  IF [NOT] HITKEY
  27.  
  28. The HITKEY condition of the IF command will test TRUE if a key has been
  29. pressed and remains in the input buffer.  For example, in the following
  30. code fragment, execution will loop endlessly until a key is pressed.
  31.  
  32.    WAIT:
  33.    IF NOT HITKEY
  34.       GOTO WAIT
  35.    ENDIF
  36.  
  37. -  KEYGET Sx
  38.  
  39. The KEYGET command gets from the user's console a single key, and places
  40. it in the specified string variable.  This command allows you to get a
  41. single keyustroke without requiring that [Enter] be pressed.  The
  42. characters placed in the string variable depend upon the key pressed.
  43. For printable characters (ASCII values 32 through 126) the actual
  44. character is used.  For other keys, the scan code in hex is placed in
  45. the variable.  To determine what is returned by a given key, use the
  46. following ASPECT commands:
  47.  
  48.    TOP:
  49.    ATSAY 10 10 31 "Press any key: "
  50.    LOCATE 10 25
  51.    KEYGET S0
  52.    ATSAY 11 25 31 "    "
  53.    FATSAY 11 10 31 "The value was: %s" S0
  54.    GOTO TOP
  55.  
  56. This command is very handy for building menus and the like where you can
  57. SWITCH on the key pressed to perform a given function.
  58.  
  59. -  IF [NOT] relation Nx Ny|integer
  60.  
  61. The IF relation commands tests for some arithmetic relation between two
  62. numeric variables or a numeric variable and an integer constant.  The
  63. valid relations are:
  64.  
  65.    GT - Greater than (Nx > Ny ?)
  66.    LT - Less than (Nx < Ny ?)
  67.    GE - Greater than or equal to (Nx >= Ny ?)
  68.    LE - Less than or equal to (Nx <= Ny ?)
  69.    EQ - Equal to (Nx = Ny ?)
  70.  
  71. For example, the following code segment tests if the value of N1 is
  72. equal or greater to 25, and branches to a subroutine if it is.
  73.  
  74.    IF GE N1 25
  75.       GOSUB SUB1
  76.    ENDIF
  77.  
  78. An additional IF condition has been added: MONO.  For example, in
  79. the following code fragment, the CLEAR command will be executed
  80. if a monochrome monitor is detected.
  81.  
  82.    IF MONO
  83.       CLEAR 7
  84.    ENDIF
  85.  
  86. Most ASPECT script commands have been modified to accept numeric
  87. variables as well as constants for the ROW, COL and ATTRIB
  88. parameters.  For example, you may now use commands such as:
  89.  
  90. ATSAY N1 N2 N3 "Use variable row, column and attrib"
  91. ATGET N1 N2 N3 N4 S0
  92. etc
  93.